home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / sputls.zip / BOXTEXT.DOC < prev    next >
Text File  |  1991-01-06  |  4KB  |  100 lines
  1. BoxText  version 1.0 (C) SPETER SOFTWARE,   January 1991.
  2.  
  3. This program will display a text string inside a box
  4.  
  5. The program was written in Borland's Turbo Pascal 5.5
  6.  
  7. Usage:
  8. ------
  9. 1:   BoxText [/h]
  10.  
  11.         Output a help screen.
  12.          /h         (optional)
  13.  
  14. 2:   BoxText [/n<char>] [/s<num>] [/q] box-type x y attr message
  15.  
  16.         Display "message" in a box starting at (x,y);
  17.           /n<char>  (optional)  sets the separator used to mark a new-line;
  18.           /s<num>   (optional)  sets the number of spaces before and after
  19.                                 the box's verticals - inside and out, the
  20.                                 default for <num> is 0;
  21.           /q        (optional)  causes quote marks at the beginning and end
  22.                                 of the message to NOT be deleted;
  23.           box-type              either  s  or  d  (single / double);
  24.           x                     top-left (column) of box, in the range [1..80];
  25.           y                     top-left (line)   of box, in the range [1..25];
  26.           attr                  character attribute [1..255] see SHOWATTR.EXE;
  27.           message               a string of text (NOT including ANSI escape
  28.                                 sequences);  the character  !  is used to force
  29.                                 a new-line in the message.  (/n can be used to
  30.                                 re-define the new-line char.)
  31.  
  32.           NOTE: The length of the command line is limited to 127 characters;
  33.                 therefore the message string has a limit of about 110 chars.
  34.  
  35. Examples:
  36. ---------
  37. (1)   BoxText /n$ /s2 s 40 3 23 Press any key to continue$     or ESC to abort!
  38.  
  39.           /n$      re-defines the new-line character from "!" to "$"
  40.           /s2      insert 2 blanks outside and inside the box:
  41.           s        use a single line box (not a double)
  42.           40 3     place the top-left of the box at column 42 of line 3
  43.                    NOTE: because /s2 was specified the corner is moved 2.
  44.           23       text attribute (white on blue)
  45.           Press..  the message
  46.      Result:
  47. 1
  48. 2 <-screen line
  49. 3                               (40,3) * ┌─────────────────────────────┐
  50. 4                                        │  Press any key to continue  │
  51. 5                                        │       or ESC to abort!      │
  52. 6                                        └─────────────────────────────┘
  53.  
  54. (2)  BoxText /s1 d 40 3 23 "       Press!any key to continue!  or ESC to abort"
  55.  
  56.           /s1      insert 1 blank outside and inside the box:
  57.           d        use a double lined box
  58.           40 3     place the top-left of the box at column 42 of line 3
  59.                    NOTE: because /s2 was specified the corner is moved 2.
  60.           23       text attribute (white on blue)
  61.           "..."    the quotes are used to indent the first line of the message
  62.      Result:
  63. 1
  64. 2 <-screen line
  65. 3                               (40,3) *╔═════════════════════╗
  66. 4                                       ║        Press        ║
  67. 5                                       ║ any key to continue ║
  68. 6                                       ║   or ESC to abort   ║
  69. 7                                       ╚═════════════════════╝
  70.  
  71. (3)  BoxText /s1 s 40 3 23 " "
  72.  
  73.           /s1      insert 1 blank outside and inside the box:
  74.           s        use a single line box (not a double)
  75.       40 3     place the top-left of the box at column 40 of line 3
  76.           23       text attribute (white on blue)
  77.       " "      the message: a single blank
  78.      Result:
  79. 1
  80. 2 <-screen line
  81. 3                               (40,3) *┌───┐
  82. 4                                       │   │
  83. 5                                       └───┘
  84.  
  85. Correspondence:
  86. ---------------
  87.     Please address any comments to:
  88.  
  89.         Stephen Peter
  90.  
  91.     INTERNET:
  92.         steve@cad0.arch.unsw.oz.au
  93.  
  94.     POST:
  95.         SPETER SOFTWARE
  96.         P.O. BOX 643
  97.         LANE COVE
  98.         NSW  2066
  99.         AUSTRALIA
  100.